home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / ada / ada_lrm4.zip / INSTALL.DOC < prev    next >
Text File  |  1989-04-07  |  16KB  |  428 lines

  1.                        Installation Instructions for
  2.                    Ada Language Reference Manual Reader
  3.                      Copyright 1989, Esther M. Lumsdon
  4.      
  5.                                       
  6.      
  7.      Source for 2 versions of the Ada Language Reference Manual Reader 
  8.      is included in the VAX/VMS distribution of this software, and 
  9.      source and executable for 1 version in the PC/AT distribution. One 
  10.      of the VAX/VMS versions (using package LRM_SMG) interfaces to the 
  11.      SMG$ routines in the VAX/VMS Run-Time Library and requires a 
  12.      VT-100 or higher terminal; the other (using package LRM_NON_SMG) 
  13.      will run on any ANSI terminal, including a paper console. The 
  14.      VAX/VMS executables were compiled under DEC VAX Ada version 1.5 
  15.      and VMS version 4.7. The PC/AT executable was compiled under 
  16.      Meridian AdaVantage version 2.1 and MS-DOS version 3.2. The SMG$ 
  17.      version draws borders on the screen, and eliminates the need for 
  18.      the user to strike the RETURN key when answering most prompts. The 
  19.      PC/AT version will run on any PC/AT with at least 1 720KB drive, 
  20.      but users will prefer to install it on a hard drive containing 
  21.      more than 1,600,000 bytes of unused disk storage.
  22.      
  23.      The data filenames are read from file or VMS logical LRMinit by 
  24.      the Ada LRM Reader program. A first step in installing the Ada LRM 
  25.      Reader for any computer is to fill a file named or a file pointed 
  26.      to by a VMS logical LRMinit with complete filenames and paths for 
  27.      the various data files used by the program.
  28.      
  29.      
  30.                                       
  31.    
  32.    
  33.    
  34.    -------------------------------------------------------------------
  35.    
  36.    
  37.    VAX/VMS Installation Instructions:
  38.    
  39.    Symbols Required:
  40.    
  41.    Define symbol(s) representing the command(s) that execute the Ada LRM
  42.    Reader. Add these commands to a .COM file that will be executed every
  43.    time a user of this software logs into your computer system, such
  44.    as the LOGIN.COM of each user, or SYS$MANAGER:SYSLOGIN.COM.
  45.    LRMPLUS == "$SYS$MANAGER:ADA_LRM_SMG.EXE"! Name and directory of executable
  46.                                             ! for Vt100-or-better-ONLY version.
  47.    LRM     == "$SYS$MANAGER:ADA_LRM.EXE"    ! Name and directory of executable
  48.                         ! for version that runs on
  49.                         ! any ANSI terminal.
  50.    
  51.    
  52.    
  53.    Logicals Required:
  54.    
  55.    These logicals must be defined before execution of Ada LRM.
  56.    
  57.    Add these commands to the LOGIN.COM file of each user of Ada LRM Reader
  58.    if you don't want Ada LRM Reader to be system-wide.
  59.    DEFINE ADA$LRM_TOOLS  "DUA0:[NEW_ADA.ADA.LRM_TOOLS]"
  60.                         ! Directory where those files sit.
  61.    DEFINE ADA$LRM        "DUA0:[NEW_ADA.ADA.ANSI_LRM]"
  62.                         ! Directory where those files sit.
  63.    DEFINE LRMINIT        "SYS$MANAGER:LRMINIT.
  64.                         ! File and path names required.
  65.    
  66.    Or...
  67.    
  68.    Add these commands to a .COM file that will be executed every time your
  69.    computer system is booted or rebooted, such as SYS$MANAGER:SYSTARTUP.COM,
  70.    if you want Ada LRM Reader to be system-wide. Requires System Manager.
  71.    
  72.    DEFINE/SYSTEM ADA$LRM_TOOLS  "DUA0:[NEW_ADA.ADA.LRM_TOOLS]"
  73.                         ! Directory where those files sit.
  74.    DEFINE/SYSTEM ADA$LRM        "DUA0:[NEW_ADA.ADA.ANSI_LRM]"
  75.                         ! Directory where those files sit.
  76.    DEFINE/SYSTEM LRMINIT        "SYS$MANAGER:LRMINIT.
  77.                         ! File and path names required.
  78.    
  79.    
  80.    
  81.    
  82.    Make the executable images Shareable (optional) :
  83.    
  84.    ADD SYS$MANAGER:ADA_LRM.EXE/OPEN/SHARE/HEADER_RESIDENT
  85.    ADD SYS$MANAGER:ADA_LRM_SMG.EXE/OPEN/SHARE/HEADER_RESIDENT
  86.    ! format for System-wide command to make these shareable
  87.    !  installed images. Requires System Manager. These commands
  88.    !  are to be used with the INSTALL utility.
  89.    
  90.    
  91.    Copy the indicated files into the directory pointed at by logical
  92.    ADA$LRM. Copy the indicated files into the directory pointed at by
  93.    logical ADA$LRM_TOOLS. Compile the indicated units (see explanation
  94.    near the end of this document). Copy the executables to the places
  95.    pointed at by symbols LRM and LRMPLUS. To run either version of the Ada
  96.    LRM Reader, type LRM or LRMPLUS.
  97.    
  98.    List of files to be placed into directory ADA$LRM (also available from
  99.    SIMTEL Ada Repository):
  100.    
  101.    A0READ.ME;1         AAREAD.ME;1         CHAP01.DOC;1        CHAP01.ERR;1
  102.    CHAP02.DOC;1        CHAP02.ERR;1        CHAP03.DOC;1        CHAP03.ERR;1
  103.    CHAP04.DOC;1        CHAP04.ERR;1        CHAP05.DOC;1        CHAP05.ERR;1
  104.    CHAP06.DOC;1        CHAP06.ERR;1        CHAP07.DOC;1        CHAP07.ERR;1
  105.    CHAP08.DOC;1        CHAP08.ERR;1        CHAP09.DOC;1        CHAP09.ERR;1
  106.    CHAP10.DOC;1        CHAP10.ERR;1        CHAP11.DOC;1        CHAP11.ERR;1
  107.    CHAP12.DOC;1        CHAP12.ERR;1        CHAP13.DOC;1        CHAP13.ERR;1
  108.    CHAP14.DOC;1        CHAP14.ERR;1        CHAPA.DOC;1         CHAPA.ERR;1
  109.    CHAPB.DOC;1         CHAPB.ERR;1         CHAPC.DOC;1         CHAPC.ERR;1
  110.    CHAPD.DOC;1         CHAPE.DOC;1         CHAPF.DOC;1         CHAPF.ERR;1
  111.    FOREWARD.D16;1      FOREWARD.DOC;1      FOREWARD.ERR;1      FTPFILES.SUB;1
  112.    INDEX.DOC;1         POSTSCRPT.D16;1     POSTSCRPT.DOC;1     POSTSCRPT.ERR;1
  113.    TOC.D16;1           TOC.DOC;1           
  114.    
  115.    
  116.    
  117.    List of files to be placed into directory ADA$LRM_TOOLS:
  118.    
  119.    LRCHAPAR.DAT;31     LRCREDIT.DAT;5                      LRMINIT.;5
  120.    LREXPLN.DAT;1       LRANNEX.MEN;1                       LRCHAPTR.MEN;1     
  121.    LRMAIN.MEN;3        LRWELCOM.MEN;1  
  122.    
  123.    
  124.      
  125.      You must create a file named LRMINIT.; It must contain all of the 
  126.      file and path names of the data files used by the Ada LRM Reader.
  127.      LRMINIT.; must contain the following, in order:
  128.      full filename for the chapter pointers file, LRCHAPAR.DAT
  129.      full filename for the credits file, LRCREDIT.DAT
  130.      full filename for the explanation file, LREXPLN.DAT
  131.      full pathname for the ANSI LRM files, ADA$LRM: in the author's     
  132.      installation
  133.      filename that text extracted from the large ANSI LRM files will     
  134.      be saved into, LRMSAVED.OUT
  135.      full filename for the main menu file, LRMAIN.MEN
  136.      full filename for the annex menu file, LRANNEX.MEN
  137.      full filename for the chapter menu file, LRCHAPTR.MEN
  138.      full filename for the welcome message, LRWELCOM.MEN
  139.      
  140.      
  141.      
  142.      
  143.      
  144.      -----------------------------------------------------------------
  145.      
  146.      
  147.      
  148.      
  149.      PC/AT Installation Instructions:
  150.      
  151.      
  152.      
  153.      You must have either a hard drive containing at least 1,600,000 
  154.      free bytes of disk storage, or at least 1 720KB diskette drive. If 
  155.      you have a hard drive, you should request the archived PC 
  156.      distribution, and enclose 3 formatted disks of 3.5" or 5.25"  
  157.      media. Otherwise, you should request the unarchived PC 
  158.      distribution, and enclose 3 formatted disks (3.5" or 5.25") of 
  159.      720KB or larger capacity.
  160.       
  161.      The distributed executable of Ada LRM Reader was compiled using an 
  162.      80286 processor. The distributed executable should run on an 8086 
  163.      or 8088 machine. If it doesn't run on yours, please contact the 
  164.      Ada Repository, or the contact person at Norfolk State University 
  165.      for help.
  166.      
  167.      After installation, to run the Ada Language Reference Manual 
  168.      Reader, just type LRM.
  169.      
  170.      The files LRM.EXE and LRMINIT must be in the same subdirectory, in 
  171.      order for the Ada LRM Reader to work. You must be in that 
  172.      subdirectory, or be running the Ada LRM Reader from a .BAT file.
  173.      
  174.      You must create a file named LRMINIT. It must contain all of the 
  175.      file and path names of the data files used by the Ada LRM Reader.
  176.      LRMINIT must contain the following, in order:
  177.      full filename for the chapter pointers file, LRCHAPAR.DAT
  178.      full filename for the credits file, LRCREDIT.DAT
  179.      full filename for the explanation file, LREXPLN.DAT
  180.      full pathname for the ANSI LR